home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / prefix.man < prev    next >
Encoding:
Text File  |  1992-07-12  |  5.1 KB  |  135 lines
  1.  
  2.  
  3.  
  4. PREFIX                    User Commands                    PREFIX
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      prefix - Manipulate the file system prefix table
  12.  
  13. SSYYNNOOPPSSIISS
  14.      pprreeffiixx [--pp [--xx _p_r_e_f_i_x]]
  15.      pprreeffiixx --MM _d_e_v_i_c_e [[--rrLL]] [[--ff]] --ll _p_r_e_f_i_x
  16.      pprreeffiixx --[[ccddUU]] _p_r_e_f_i_x
  17.      pprreeffiixx --aa _p_r_e_f_i_x [--ss _s_e_r_v_e_r]
  18.      pprreeffiixx --xx _p_r_e_f_i_x --[[hhHH]] _h_o_s_t
  19.      pprreeffiixx --xx _p_r_e_f_i_x --ll _l_o_c_a_l_N_a_m_e
  20.  
  21. OOPPTTIIOONNSS
  22.      --pp            (The default.) Print  out  the  prefix  table.
  23.                    With --xx, print the export list of a prefix.
  24.  
  25.      --xx _p_r_e_f_i_x     Export a local directory given by --ll under the
  26.                    name  _p_r_e_f_i_x,  or  use  with --hh (--HH) to export
  27.                    (not export) the prefix to a particular host.
  28.  
  29.      --MM _d_e_v_i_c_e     Mount the device under the local name given by
  30.                    the --ll option.  The local name is exported.
  31.  
  32.      --LL            Use with --MM to prevent exporting the prefix.
  33.  
  34.      --rr            Mount read-only.  Use with --MM.
  35.  
  36.      --UU _p_r_e_f_i_x     Unmount the file system with the given prefix.
  37.  
  38.      --ff            Force the installation  of  the  prefix,  i.e.
  39.                    don't do a stat to make sure the link exists.
  40.  
  41.      --ll _d_i_r_N_a_m_e    Specifies local name.  Used with --MM (mount) or
  42.                    --xx (export).
  43.  
  44.      --hh _h_o_s_t       Add _h_o_s_t to the export  list  associated  with
  45.                    the  prefix  given by the --xx option.  _H_o_s_t can
  46.                    either be the name of the server or its Sprite
  47.                    ID.
  48.  
  49.      --HH _h_o_s_t       Remove _h_o_s_t from the  export  list  associated
  50.                    with  the prefix given by the --xx option.  _H_o_s_t
  51.                    can either be the name of the  server  or  its
  52.                    Sprite ID.
  53.  
  54.      --aa _p_r_e_f_i_x     Add _p_r_e_f_i_x to the  prefix  table.  If  the  --ss
  55.                    option  is  not given a broadcast will be done
  56.                    to find the server.
  57.  
  58.      --ss _s_e_r_v_e_r     Specify the server for the prefix given by the
  59.                    --aa  option.   _S_e_r_v_e_r can either be the name of
  60.  
  61.  
  62.  
  63. Sprite v.1.0         Printed:  July 11, 1992                    1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PREFIX                    User Commands                    PREFIX
  71.  
  72.  
  73.  
  74.                    the server or its Sprite ID.  If _s_e_r_v_e_r is 0 a
  75.                    broadcast will be done to find the server.
  76.  
  77.      --cc _p_r_e_f_i_x     Clear  the  server  binding  for  _p_r_e_f_i_x,  but
  78.                    retain the prefix in the prefix table.
  79.  
  80.      --dd _p_r_e_f_i_x     Delete _p_r_e_f_i_x  from  the  prefix  table  alto-
  81.                    gether.
  82.  
  83. _________________________________________________________________
  84.  
  85.  
  86. DDEESSCCRRIIPPTTIIOONN
  87.      Prefix tables are cached mappings from file name prefixes to
  88.      the  servers that keep files under that prefix.   Under nor-
  89.      mal operation the prefix table is updated automatically as a
  90.      side-effect  of pathname lookup.  The pprreeffiixx command is used
  91.      to display the file system's prefix table, and to manipulate
  92.      its  individual  entries.   If  no options are given, prefix
  93.      prints out the contents of the prefix table (just as if  the
  94.      --pp  switch had been given).  If options are given, then they
  95.      control what happens, as described above.
  96.  
  97. PPRREEFFIIXXEESS AANNDD SSPPRRIITTEE
  98.      The presense of a prefix is indicated by remote links in the
  99.      file system.  A remote link is a circular symbolic link with
  100.      a special type.   They are created via the "ln -r"  command.
  101.      When  a  server  encounters  a remote link during lookup, it
  102.      returns the prefix indicated  by  the  remote  link  to  the
  103.      client that initiated the lookup.  The client loads the pre-
  104.      fix (if it isn't already loaded), broadcasts for the  server
  105.      of  the prefix (if it doesn't already know who that is), and
  106.      then sends the lookup operation to the new server.  Thus the
  107.      root server is bypassed after prefixes are loaded.  Prefixes
  108.      can be nested arbitrarily; remote links  can  occur  in  any
  109.      directory.
  110.  
  111.      Servers mount local disks under a prefix that gets  exported
  112.      to other Sprite hosts using the -M option.  Servers can con-
  113.      trol what hosts have access to a prefix by adding entries to
  114.      an  export  list using the -h option.  If the export list is
  115.      empty the prefix is exported to all  hosts,  so  adding  one
  116.      exportee effectivly prevents access to all other hosts.
  117.  
  118. KKEEYYWWOORRDDSS
  119.      prefix table, mount
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131. Sprite v.1.0         Printed:  July 11, 1992                    2
  132.  
  133.  
  134.  
  135.